Skip to main content
Version: 2026.05

API Reference

The Istari Digital MCP Service gives LLMs access to the Istari platform through two tools: search and execute.

search(code)​

Discovers available Istari API methods. The LLM writes a Python expression to filter the list of available methods and their parameters.

Example — find all job-related methods:

[m for m in spec if m["domain"] == "jobs"]

Example — look up a specific method:

next(m for m in spec if m["name"] == "list_resources")

Example — find methods that accept a system ID:

[m for m in spec if any(p["name"] == "system_id" for p in m["parameters"])]

execute(code)​

Runs Python code against the Istari API on behalf of the authenticated user. The LLM uses the results of search to construct and execute API calls.

Supported operations include:

  • Resources — list, fetch, and browse revision history
  • Jobs — submit, monitor, and manage analysis jobs
  • Systems — create and manage systems and configurations
  • Access — view and manage resource sharing
  • Agents — list and inspect agents and agent pools
  • Users — look up user information
  • Storage — generate download URLs for files

File upload is not supported through the MCP service. To upload files, ask the LLM to generate a local Python script you can run on your own machine.

Typical workflow​

  1. The LLM calls search to find the right method and confirm its parameters
  2. The LLM calls execute to run the operation and return results